home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tri_bbs / tbcbv12.zip / CALLBACK.DOC < prev    next >
Text File  |  1992-08-10  |  15KB  |  310 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                     CallBack
  24.                       Callback Verifier for the TriBBS BBS
  25.                       Copyright (C) 1992 by Adam Zuckerman
  26.                               All rights reserved.
  27. CallBack version 1.2                                                     Page 1
  28.  
  29.  
  30. Files included with this ZIP:
  31.  
  32. File          Size      Date      Description
  33. ------------  --------  --------  ---------------------------------------------
  34.  
  35. CallBack.EXE    90,948  08-02-92  The executable file that performs the
  36.                                   callback verification.
  37.  
  38. CallBack.DOC    14,808  08-09-92  This document.
  39.  
  40. CallBack.CFG       949  07-30-92  This file is the configuration text for
  41.                                   CallBack.
  42.  
  43. CallBack.BAT        83  07-10-92  This file is the batch file that runs
  44.                                   CallBack.
  45.  
  46. BuildPH.EXE     38,814  08-04-92  The executable to build PHONES.DAT from your
  47.                                   TriBBS USERS.DAT file.
  48.  
  49. History.120      1,118  08-09-92  This file lists the history of CallBack.
  50.  
  51. CallBack version 1.2                                                     Page 2
  52.  
  53. CallBack is shareware and is being released in a shareware fashion.  Shareware
  54. is a great concept.  It allows you to try before you buy.  Then you can decide
  55. if this software fills your needs or not.  The registration fee for CallBack is
  56. $15 US.  The registration fee gives you free updates (if there are any), a
  57. printed manual, and the ability to upgrade the caller's security level and
  58. remaining on-line time.  For registration of $100 US, you will also get the
  59. source code.  Registration outside the US is $15 US.  Registration outside the
  60. US is limited to only those countries whose phone system uses US style phone
  61. numbers (i.e. 404-292-5303).  If your country does not use this style of phone
  62. number, then send me private mail (see Support on how to contact me) and I will
  63. make a version specific to your country.  This software is the intellectual
  64. property of Adam Zuckerman.  You are given license to use the software for 30
  65. days.  If you do not register CallBack, you MUST discontinue its use.  Please
  66. support the shareware concept and register your copy of CallBack.
  67.  
  68.  
  69. Now that the legal stuff is out of the way, we should begin our discussion of
  70. CallBack.  CallBack is a program written in PDS 7.1 (QuickBASIC Professional).
  71. It allows your callers to be verified by your board.  It will prompt the caller
  72. for their data phone number and allow them to change it if necessary.  It will
  73. call back the user a specified number of times (sysop configurable).  You can
  74. use an unusual physical port address with CallBack.  Upon verification, you can
  75. add to the caller's time and security level (registered version only).
  76.  
  77.  
  78. CallBack has been thoroughly tested under Desqview.  The few problems that have
  79. occurred have been related to opening a DOS window with communications set to
  80. NONE.  If this occurs (extremely remote possibility), have the caller attempt
  81. the callback verification again.
  82. CallBack version 1.2                                                     Page 3
  83.  
  84.  
  85. The format of the configuration file is:
  86.  
  87. The Dining Room                         ; BBS name
  88. Adam Zuckerman                          ; SysOp name
  89. C:\TriBBS                               ; Path to TriBBS node 1
  90. C:\TriBBS                               ; Path to current TriBBS node
  91. COM1                                    ; Com port (1 or 2 only)
  92. 3F8                                     ; Com port physical address
  93. ATM1E1Q0H0                              ; Modem init string
  94. ATDT                                    ; Dialing prefix
  95. CONNECT                                 ; Connect message from modem
  96. 15                                      ; Security level after verification
  97. 10                                      ; Minutes to add to caller's time
  98. 3                                       ; Number of callback attempts to make
  99. 1                                       ; Long distance: 0-all, 1-drop, 2-none
  100. 15                                      ; Time to pause between attempts
  101.  
  102.  
  103. All filenames must have the complete pathname for the file including the drive
  104. letter specification.  Expect the configuration file to change with any later
  105. releases of CallBack.
  106.  
  107.  
  108. Now, let's look at the configuration file in detail.  First, the first 2 lines
  109. are self-explanatory.
  110.  
  111.      The Dining Room                         ; BBS name
  112.      Adam Zuckerman                          ; SysOp name
  113.  
  114. Change these to suit your board.  Next comes the pathes to TriBBS.  Line 3 is
  115. the path to your node 1 directory.  If node 1 is in C:\TriBBS then you won't
  116. have to change a thing.  If you are running a single node system, line 4 will
  117. be the same as line 3.  Otherwise, you will need to change it to the full path
  118. that leads to node 2 (e.g. Node 2 is in C:\TriBBS2, line 4 would be
  119. C:\TriBBS2).
  120.  
  121.      C:\TriBBS                               ; Path to TriBBS node 1
  122.      C:\TriBBS                               ; Path to current TriBBS node
  123.  
  124. Line 5 is going to be a bit tricky to explain.  It must be COM1 or COM2.  This
  125. is the communications port name.  If you are using COM3, then tell CallBack to
  126. use COM1 and change the physical address in line 6.  More on this in a minute.
  127. Line 6 is the physical port address of the communications port.  For COM1, it
  128. is normally 3F8.  COM2 is 2F8.  COM3 is 3E8.  And COM4 is 2E8.  If you are
  129. using COM3 or COM4, then you will have to change the physical port address in
  130. line 6.  If you are not sure what the physical address is, contact me directly,
  131. via The Dining Room bbs (404) 292-5303.  I'll get a program to you that will
  132. let you know what your physical port addresses are.  If you are using COM3 or
  133. COM4, changing the physical port address will allow you to continue to use that
  134. communications port.  DOUBLE CHECK the physical port address if you change it.
  135. If you put in a WRONG ADDRESS, YOU CAN HANG YOUR SYSTEM OR CAUSE DAMAGE TO YOUR
  136. DATA.
  137.  
  138.      COM1                                    ; Com port (1 or 2 only)
  139.      3F8                                     ; Com port physical address
  140. CallBack version 1.2                                                     Page 4
  141.  
  142.  
  143. Line 7 is the initialization string for your modem.  If your are using a HAYES
  144. compatible modem, then the initialization string listed will work best for you.
  145. Consult your modem manual to insure that the command echo is turned on,
  146. responses are set to verbose (e.g CONNECT, BUSY, NO CARRIER), and your modem
  147. goes on-hook (hangs up).
  148.  
  149.      ATM1E1Q0H0                              ; Modem init string
  150.  
  151. Line 8 is the dialing prefix string needed to call the user back.  For most
  152. systems, the default is all you need.  If you run your board out of a business
  153. where dialing out requires a special code (e.g. 9 for an outside line), the
  154. you would change line 8.  If you have call-waiting, change line 8 to ATDT*70,
  155.  
  156.      ATDT                                    ; Dialing prefix
  157.  
  158. Line 9 is the message sent back from your modem indicating that a connection
  159. has been made.  Some modems do not send out a standard HAYES response.  Change
  160. this as necessary.
  161.  
  162.      CONNECT                                 ; Connect message from modem
  163.  
  164. Line 10 is the security level that a verified caller will receive upon
  165. completion of the callback process (registered version only).  If a caller 
  166. with a higher security level attempts to use CallBack, they will receive a
  167. message stating that their security level is too high and be returned to the
  168. board.
  169.  
  170.      15                                      ; Security level after verification
  171.  
  172. Line 11 is the amount of time to add to a caller's on-line time once they have
  173. been verified.  This is an exclusive feature of CallBack (registered version
  174. only).  You can add from 0 to as many minutes as you want.  Only TriBBS limits
  175. what you can set.  TriBBS will still limit the caller to the maximum time per
  176. call set up in the node configuration.
  177.  
  178.      10                                      ; Minutes to add to caller's time
  179.  
  180. Line 12 tells CallBack how many attempts to make to reach the caller at the
  181. number supplied by the caller.  Again, you can set this as high as you would
  182. like.
  183.  
  184.      3                                       ; Number of callback attempts
  185.  
  186. Line 13 sets CallBack to accept or deny long distance callbacks.  Setting line
  187. 13 to 0 says to accept all callbacks.  Upon verification, drop back to TriBBS
  188. and continue.  Leaving line 13 set to 1 will have CallBack accept the long
  189. distance callback.  Upon verification, the caller is told that their time and
  190. security level have been upgraded (registered version only).  It then tells the
  191. caller that he/she will have the modem hang up.  Changing line 13 to 2 will
  192. tell CallBack not to accept any long distance callbacks.
  193.  
  194.      1                                       ; Long distance: 0-all, 1-drop
  195. CallBack version 1.2                                                     Page 5
  196.  
  197.  
  198. Line 14 tells CallBack how long to pause between callback attempts.  I 
  199. recommend setting it to 15 secondes.  If there is no value in this line, then
  200. CallBack defaults to 15 seconds.
  201.  
  202.      15                                      ; Time to pause between attempts
  203.  
  204.  
  205.  
  206. For the following examples, CBV1.BAT is used for the batch file name.  If you
  207. have 2 or more nodes, I recommend using CBV1.BAT for node 1, CBV2.BAT for node
  208. 2, etc.  Also do the same with the configuration files (e.g. CBV1.CFG for node
  209. 1, CBV2.CFG for node 2, etc.).  The default setup from me has the batch and
  210. configuration files called CALLBACK.???.
  211.  
  212.  
  213. Setting up CallBack as a door is fairly simple.  The door type is T for TriBBS.
  214. The batch file should be set up in the current node and look like the batch
  215. file listed further down on this page.  Security level should be set to your
  216. new user security level.
  217.  
  218.      T,Call Back Verifier,CBV1.BAT,10
  219.  
  220.  
  221. Setting up CallBack in your NEWUSER.BAT is also fairly simple.  Just have a
  222. batch file that looks like this:
  223.  
  224.     cd c:\TriBBS\doors\CallBack
  225.     CallBack CBV1.CFG
  226.     cd c:\TriBBS
  227.     board
  228.  
  229. CBV1.CFG is the configuration file for the current node.
  230.  
  231.  
  232. CallBack can also be setup up as an extended menu command.  Refer to the TriBBS
  233. documentation for further details.
  234.  
  235.  
  236. With release 1.2, I have included a utility program for building the PHONES.DAT
  237. file.  This program (BuildPH.EXE) will go through your USERS.DAT file, finding
  238. all of you callers with a specified security level or higher, and build the
  239. duplicate phone number data file (PHONES.DAT).  This program requires your 
  240. CallBack.KEY to be in the same directory when executed.  This utility is a one
  241. time only kind of utility.  Once you run it, it has built the PHONES.DAT file
  242. for you.  It won't be necessary to use it again (excepting any loss of data).
  243. To start BuildPhone, type at the DOS prompt:
  244.  
  245.      BuildPH C:\TriBBS C:\TriBBS\doors\CallBack 15
  246.  
  247. This will build PHONES.DAT with all callers from your USERS.DAT file with a
  248. security level of 15 or higher.  The first path is the path to TriBBS's node 1.
  249. The second path is to CallBack's sub-directory (where PHONES.DAT is actually
  250. located.
  251. CallBack version 1.2                                                     Page 6
  252.  
  253.  
  254.                                     Support
  255.  
  256. For support, I can be reached via TTN, SmartNet, AFS, or my board, The Dining
  257. Room (404) 292-5303.   The fastest way to reach me would be my board.  Leave me
  258. a comment.  I will respond within 24 hours.  I will help all users of CallBack.
  259. If you are not registered, don't worry.  I won't bite your head off.  I will
  260. help you with whatever problem you have.
  261.  
  262.  
  263. Once you have registered, all subsequent versions of CallBack will accept your
  264. registration key (thanks to Mark Goodwin for the idea).
  265.  
  266.  
  267. Please fill out the enclosed registration form and mail it to:
  268.  
  269.    Adam Zuckerman
  270.    1364 Debden Place
  271.    Stone Mountain, GA 30083-1212
  272.  
  273. Please make all checks payable to Adam Zuckerman.
  274.  
  275.  
  276.  
  277.  
  278.                            CallBack Registration Form
  279.  
  280. +------------------------------------------------------------------------------+
  281. |                                                                              |
  282. |  Name:___________________________________  [] CallBack Registration $15.00US |
  283. |                                            [] Printed Manual           N/C   |
  284. |  Address:________________________________  [] Foreign Registration     N/A   |
  285. |                                            [] Source Code           $85.00US |
  286. |  City:___________________ State:_________  [] Catalog of software      N/C   |
  287. |                                                                              |
  288. |  Zip Code:_______________ Zip+4:_________                                    |
  289. |                                                                              |
  290. |  Make checks payable to: Adam Zuckerman        Total Enclosed    $_____.___  |
  291. |                                                                              |
  292. |  Where did you get CallBack?                                                 |
  293. |  [] Local BBS              Name ___________________________________________  |
  294. |                            Their phone number: (_____)____-_________         |
  295. |                                                                              |
  296. |  [] Information Service    [] America On Line                                |
  297. |                            [] BIX                                            |
  298. |                            [] Compuserve                                     |
  299. |                            [] Delphi                                         |
  300. |                            [] GEnie                                          |
  301. |                            [] Other _______________________________________  |
  302. |                                                                              |
  303. |  [] Directly from me (Adam Zuckerman)                                        |
  304. |                                                                              |
  305. |  [] Friend                 Name ___________________________________________  |
  306. |                                                                              |
  307. |  [] Shareware outlet house Name ___________________________________________  |
  308. |  1.2                                                                         |
  309. +------------------------------------------------------------------------------+
  310.